home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / sitemgr / ch5.z / ch5
Text File  |  2001-04-17  |  21KB  |  463 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        5.  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  9.  
  10.        5.1  _U_p_g_r_a_d_i_n_g__f_r_o_m__a__P_r_e_v_i_o_u_s__V_e_r_s_i_o_n__o_f__S_i_t_e_M_g_r
  11.  
  12.           +o When upgrading from an earlier version of SiteMgr, the
  13.             web site database that was previously built by the
  14.             SiteMgr initialization process will need to be
  15.             upgraded. This operation can be done easily from within
  16.             the SiteMgr client, when you first attempt to load the
  17.             particular web site (you will be prompted accordingly).
  18.  
  19.             However, before this operation can happen, the server
  20.             machine that contains the SiteMgr database (the
  21.             machine/web site being administered by SiteMgr) _m_u_s_t be
  22.             upgraded with the latest SiteMgr software, in
  23.             particular, _s_i_t_e_m_g_r._s_w._b_a_s_e and _s_i_t_e_m_g_r._s_w._s_e_r_v_e_r,
  24.             version 1.1 (the version of the Server Extensions and
  25.             the Client _m_u_s_t match).
  26.  
  27.        5.2  _I_n_i_t_i_a_l_i_z_a_t_i_o_n__a_n_d__S_e_t_u_p
  28.  
  29.           +o Before beginning, please read the "_I_n_s_t_a_l_l_a_t_i_o_n
  30.             _I_n_f_o_r_m_a_t_i_o_n" chapter of these release notes if you
  31.             haven't already done so. It provides detailed
  32.             information on enabling the HTTP server for SiteMgr
  33.             access, establishing a secure environment for SiteMgr,
  34.             and other very important items.
  35.  
  36.           +o The initial database creation step may take some time,
  37.             proportional to the number of documents in your doc
  38.             root. The database initialization dialog requests
  39.             appropriate email address(es) in order to alert you
  40.             when the database has been created and is ready for
  41.             access. Until that message is received, you cannot
  42.             access the database.  Feedback from the initialization
  43.             process is available from the client in the form of a
  44.             document counter, which is returned when the "_L_o_a_d _W_e_b
  45.             _S_i_t_e" button is clicked in the client.
  46.  
  47.           +o If you are running a separate HTTP server instance for
  48.             utilizing SiteMgr (see "_I_n_s_t_a_l_l_a_t_i_o_n _I_n_f_o_r_m_a_t_i_o_n" for
  49.             information concerning this topic), make sure you
  50.             differentiate between the "_S_i_t_e_M_g_r _S_e_r_v_e_r/_L_o_c_a_t_i_o_n:"
  51.             and the "_S_e_r_v_e_r/_L_o_c_a_t_i_o_n:" in the SiteMgr
  52.             Initialization dialog.
  53.  
  54.             The value specified for the "_S_e_r_v_e_r/_L_o_c_a_t_i_o_n:" field
  55.             should be the server and port that people normally use
  56.             to view your site. For example, the two entries may
  57.             look like:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.                     _S_i_t_e_M_g_r _S_e_r_v_e_r/_L_o_c_a_t_i_o_n:  http://www.foo.com:6949
  75.                     _S_e_r_v_e_r/_L_o_c_a_t_i_o_n:          http://www.foo.com
  76.  
  77.             If SiteMgr is being run through the same HTTP server
  78.             instance that people normally use to view your site,
  79.             then the entries should be identical.
  80.  
  81.           +o When initializing the database, SiteMgr _o_n_l_y picks up
  82.             documents and directories that are found off the
  83.             document root for the HTTP server instance you have
  84.             specified. Documents and directories can be in the form
  85.             of symbolic links (which are automatically followed),
  86.             found somewhere within the document root. Anything
  87.             outside of the document root will _n_o_t be picked up if
  88.             there is no symbolic link to it from within the
  89.             document root.
  90.  
  91.             In particular, user documents with URLs of the form
  92.             _h_t_t_p://_w_w_w._f_o_o._c_o_m/~_j_s_m_i_t_h/_f_o_o._h_t_m_l will not be found
  93.             unless there is a symbolic link from within the
  94.             document root to the user's Unix directory (default
  95.             location ~_j_s_m_i_t_h/_p_u_b_l_i_c__h_t_m_l).
  96.  
  97.           +o If, after initialization, your entire web site (under
  98.             the document root) is not showing up in SiteMgr, this
  99.             may be due to the fact that certain directories are
  100.             excluded from processing. They can be set via the
  101.             _D_i_r_e_c_t_o_r_i_e_s _t_o _E_x_c_l_u_d_e _F_r_o_m _P_r_o_c_e_s_s_i_n_g: text entry
  102.             field in the SiteMgr Initialization dialog form. These
  103.             directories are excluded to provide the user with a
  104.             more accurate picture of the web site, avoiding any
  105.             files installed from other products and concentrating
  106.             on the true content for the site. For this reason (and
  107.             to avoid accidental deletion/modification of files in
  108.             these areas, AND to speed up processing), it is
  109.             recommended that you _d_o _n_o_t _r_e_m_o_v_e _e_n_t_r_i_e_s _f_r_o_m _t_h_i_s
  110.             _l_i_s_t _u_n_l_e_s_s _a_b_s_o_l_u_t_e_l_y _n_e_c_e_s_s_a_r_y. You may _a_d_d to this
  111.             list as appropriate for your particular web site.
  112.             Directories listed by default include:
  113.  
  114.  
  115.                     {_d_o_c__r_o_o_t}/_D_e_m_o_s
  116.                     {_d_o_c__r_o_o_t}/_O_u_t_O_f_B_o_x
  117.                     {_d_o_c__r_o_o_t}/_S_o_f_t_W_i_n_d_o_w_s
  118.                     {_d_o_c__r_o_o_t}/_S_y_s_S_e_t_u_p
  119.                     {_d_o_c__r_o_o_t}/_S_u_r_f_Z_o_n_e
  120.                     {_d_o_c__r_o_o_t}/_S_y_s_T_o_u_r
  121.                     {_d_o_c__r_o_o_t}/_W_h_a_t_s_N_e_w
  122.                     {_d_o_c__r_o_o_t}/_d_e_m_o_s
  123.                     {_d_o_c__r_o_o_t}/_i_j
  124.                     {_d_o_c__r_o_o_t}/_i_n_f_o_s_e_a_r_c_h
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.                     {_d_o_c__r_o_o_t}/_j_u_n_c_t_i_o_n
  141.                     {_d_o_c__r_o_o_t}/_l_i_b_r_a_r_y
  142.                     {_d_o_c__r_o_o_t}/_o_2_s_t_a_r_t
  143.                     {_d_o_c__r_o_o_t}/_r_o_o_t
  144.                     {_d_o_c__r_o_o_t}/_s_y_s_m_g_r
  145.                     {_d_o_c__r_o_o_t}/_w_e_b_d_i_s_t
  146.  
  147.           +o If the initialization process was somehow aborted, the
  148.             file <document_root>/.sitemgr/sm.init must be removed
  149.             before initialization can be done again.
  150.  
  151.           +o If you need to _c_o_m_p_l_e_t_e_l_y _r_e-_i_n_i_t_i_a_l_i_z_e your database,
  152.             you can run the following command from a shell (where
  153.             <_d_o_c_u_m_e_n_t__r_o_o_t> could be /_v_a_r/_w_w_w/_h_t_d_o_c_s, for example):
  154.  
  155.  
  156.                     #### ////uuuussssrrrr////ssssiiiitttteeeemmmmggggrrrr////bbbbiiiinnnn////ssssmmmmddddbbbbffff....ccccggggiiii <<<<ddddooooccccuuuummmmeeeennnntttt____rrrrooooooootttt>>>>
  157.  
  158.             If this process is somehow aborted, the file
  159.             <document_root>/.sitemgr/sm.init must be removed before
  160.             smdbf.cgi can be executed again.
  161.  
  162.             This function can also be performed from the SiteMgr
  163.             client:
  164.  
  165.                +o Load the web site you wish to re-initialize.
  166.  
  167.                +o Access the menu item "Initialize (New) Site..."
  168.                  found under the "Views" menu.
  169.  
  170.                +o The SiteMgr Initialization dialog will be brought
  171.                  up with all relevant information filled in for the
  172.                  site you have loaded.  Clicking the "Initialize
  173.                  Database" pushbutton will perform the operation
  174.                  for you.
  175.  
  176.           +o _U_p_d_a_t_i_n_g the database can be done from within the
  177.             SiteMgr client, under the menu item "Views" > "Update
  178.             Site Information". Follow the instructions on the
  179.             dialog and click the "Update Database" pushbutton.
  180.  
  181.             Updating the database should be done in the event that
  182.             documents on your site are changed without going
  183.             through the SiteMgr client.  For example, editing or
  184.             removing documents directly within the document root.
  185.             SiteMgr should detect the modifications made within
  186.             your document root and put the database in sync.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        5.3  _V_e_r_s_i_o_n__C_o_n_t_r_o_l
  207.  
  208.           +o If you specify to use "Version Control" in the SiteMgr
  209.             Initialization dialog, the SiteMgr server extensions
  210.             (CGI) will look for the existence of a Revision Control
  211.             System (RCS) Utility program (/_u_s_r/_s_b_i_n/_r_c_s). If you
  212.             have installed the RCS binaries in a different location
  213.             location, you should create the following symbolic
  214.             links:
  215.  
  216.                     #### llllnnnn ----ssss  <<<<yyyyoooouuuurrrr____llllooooccccaaaattttiiiioooonnnn>>>>////rrrrccccssss ////uuuussssrrrr////ssssbbbbiiiinnnn////rrrrccccssss
  217.                     #### llllnnnn ----ssss  <<<<yyyyoooouuuurrrr____llllooooccccaaaattttiiiioooonnnn>>>>////cccciiii ////uuuussssrrrr////ssssbbbbiiiinnnn////cccciiii
  218.                     #### llllnnnn ----ssss  <<<<yyyyoooouuuurrrr____llllooooccccaaaattttiiiioooonnnn>>>>////ccccoooo ////uuuussssrrrr////ssssbbbbiiiinnnn////ccccoooo
  219.                     #### llllnnnn ----ssss  <<<<yyyyoooouuuurrrr____llllooooccccaaaattttiiiioooonnnn>>>>////rrrrccccssssmmmmeeeerrrrggggeeee ////uuuussssrrrr////ssssbbbbiiiinnnn////rrrrccccssssmmmmeeeerrrrggggeeee
  220.                     #### llllnnnn ----ssss  <<<<yyyyoooouuuurrrr____llllooooccccaaaattttiiiioooonnnn>>>>////rrrrccccssssddddiiiiffffffff ////uuuussssrrrr////ssssbbbbiiiinnnn////rrrrccccssssddddiiiiffffffff
  221.                     #### llllnnnn ----ssss  <<<<yyyyoooouuuurrrr____llllooooccccaaaattttiiiioooonnnn>>>>////rrrrlllloooogggg ////uuuussssrrrr////ssssbbbbiiiinnnn////rrrrlllloooogggg
  222.  
  223.             The Revision Control System (RCS) Utilities can be
  224.             installed from _e_o_e._s_w._r_c_s. On IRIX 6.2 systems, you can
  225.             install that subsystem from your IRIX 6.2 part 1 of 2
  226.             CD. On IRIX 6.3/4/5 systems, you can install it from
  227.             your IRIX 6.3/4/5 CD.
  228.  
  229.           +o If "Version Control" is turned off, you will lose the
  230.             ability to track multiple versions of HTML, VRML and
  231.             text files (and also apply revision comments to them);
  232.             as well as apply locks to documents, etc. Image files
  233.             and other binary objects are not placed under RCS
  234.             control (no multiple versions, etc.) at this time.
  235.  
  236.           +o If "Version Control" is turned on, RCS subdirectories
  237.             will be created in every directory of your site if they
  238.             do not already exist. Thus, the timestamp of every
  239.             directory in your site will be set to the time at which
  240.             you initialize the database. Whenever you update the
  241.             database, files that were changed outside of SiteMgr
  242.             will be checked in and the timestamp of directories in
  243.             which they reside will be reset.
  244.  
  245.  
  246.        5.4  _H_a_n_d_l_i_n_g__D_o_c_u_m_e_n_t_s__W_i_t_h_i_n__Y_o_u_r__S_i_t_e
  247.  
  248.           +o Image map files referenced within a HTML document are
  249.             not used for this release of SiteMgr. The
  250.             recommendation is to embed your image map information
  251.             within your document, as outlined in the HTML 3.0
  252.             specification (utilize the "<MAP>" element/tag).
  253.  
  254.           +o At this time, directories within the document root are
  255.             not handled as a "first-class" objects. When specifying
  256.             the removal of a directory, the documents will indeed
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.             be removed, but the directory does not get removed. You
  273.             can accomplish the removal of the empty directory(ies)
  274.             with the rmdir (or rm) command(s), if you wish to fully
  275.             clean up your document root.
  276.  
  277.             SiteMgr does not display empty directories (that exist
  278.             under your document root) to the end-user. However, you
  279.             can safely "create" a directory view ("New Directory")
  280.             in the SiteMgr client with the same name as an empty
  281.             directory that exists under your document root and
  282.             populate it with documents, and no problems should
  283.             arise.
  284.  
  285.           +o Another situation with the removal operation that the
  286.             site administrator should be made aware of occurs when
  287.             "Version Control" is turned on within SiteMgr. In this
  288.             case, after a removal operation is performed, SiteMgr
  289.             does _n_o_t delete the RCS history file. For example,
  290.             removing /my_dir/foo.html will not delete the
  291.             accompanying history file, /my_dir/RCS/foo.html,v. This
  292.             is by design, but may be subject to change in future
  293.             releases. It was done in this manner to provide a
  294.             "safety-net" for the site administrator, in the case of
  295.             accidental deletion. Recovery is possible through the
  296.             RCS command set, allowing for re-creation of the
  297.             deleted file. See _R_C_S(_1) for more information.
  298.  
  299.           +o When validating the HTML encoding of a document,
  300.             SiteMgr utilizes the program _w_e_b_l_i_n_t. In order to find
  301.             this program, SiteMgr looks for the existence of
  302.             /_u_s_r/_l_o_c_a_l/_b_i_n/_w_e_b_l_i_n_t. If SiteMgr fails to find
  303.             _w_e_b_l_i_n_t in that location, it will use its own local
  304.             copy found in /_u_s_r/_s_i_t_e_m_g_r/_b_i_n (_w_e_b_l_i_n_t version 1.017).
  305.  
  306.           +o Validation of VRML encoding works only for VRML 1.0
  307.             files at this time.
  308.  
  309.           +o If you wish to enable the spell checking feature for
  310.             the Validation module, you will need to install
  311.             _e_o_e._s_w._s_p_e_l_l (the Spell Utilities), if this subsystem
  312.             is not already installed on the server machine.
  313.  
  314.  
  315.        5.5  _S_i_t_e_M_g_r__C_l_i_e_n_t
  316.  
  317.           +o The client can (possibly) get into a "hung" state if
  318.             the SiteMgr Server Extensions (_s_i_t_e_m_g_r._s_w._s_e_r_v_e_r) are
  319.             used in conjunction with a Netscape FastTrack Personal
  320.             Server, version 2.0P (_n_s__f_a_s_t_t_r_a_c_k) or earlier.  In
  321.             earlier versions of this server there were problems
  322.             handling CGI (Common Gateway Interface) processes which
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.             could cause this situation. The workaround is to
  339.             upgrade to (at least) version 2.01 of _n_s__f_a_s_t_t_r_a_c_k.
  340.             Version 2.01 can be found on the IRIX 6.5 Applications
  341.             CD, or on the IRIX Applications CD (for IRIX 6.2, 6.3
  342.             and 6.4) which was released in August of 1997.
  343.  
  344.           +o _U_p_d_a_t_i_n_g the database can be done from within the
  345.             SiteMgr client, under the menu item "Views" > "Update
  346.             Site Information...". Follow the instructions on the
  347.             dialog and click the "Update Database" pushbutton.
  348.  
  349.             Updating the database should be done in the event that
  350.             documents on your site are changed without going
  351.             through the SiteMgr client.  For example, editing or
  352.             removing documents directly within the document root.
  353.             SiteMgr should detect the modifications made within
  354.             your document root and put the database in sync.
  355.  
  356.           +o Sites making use of the _O_u_t_B_o_x _P_e_r_s_o_n_a_l _W_e_b _S_i_t_e _T_o_o_l_s
  357.             (_o_u_t_b_o_x._s_w.*) for maintaining content may want to also
  358.             use SiteMgr. Note that SiteMgr could be used in place
  359.             of the OutBox Tools; however, utilizing both tools is
  360.             indeed possible. In that case, files published,
  361.             removed, or updated through the OutBox Tools need to be
  362.             "recognized" by the SiteMgr server/database.  To make
  363.             that happen, the SiteMgr database needs to be updated
  364.             so that it reflects the changes made to the site.  From
  365.             the SiteMgr client, access the menu item "Views" >
  366.             "Update Site Information", follow the instructions on
  367.             the dialog, and click "Update Database" pushbutton.
  368.  
  369.           +o Administering a site (or following links from the
  370.             Preview window) through a firewall situation (utilizing
  371.             a SOCKS host, for instance) requires the use of the
  372.             -_w_e_b_p_r_e_f_s (or -_w_e_b) command-line option when starting
  373.             up the SiteMgr client:
  374.  
  375.  
  376.                     %%%% ////uuuussssrrrr////ssssbbbbiiiinnnn////ssssiiiitttteeeemmmmggggrrrr ----wwwweeeebbbbpppprrrreeeeffffssss
  377.  
  378.             See _s_i_t_e_m_g_r(_1) for more information on all command-line
  379.             options.
  380.  
  381.           +o The Print ("Print Document...") functionality found
  382.             within the Preview panel is rather basic, and does not
  383.             support a complete HTML 3.x tagset.  In particular,
  384.             tables are not formatted correctly. This will be
  385.             corrected in a future release. Printing of more
  386.             "complex" HTML documents may best be done through an
  387.             alternate browser (which can be chosen within the
  388.             SiteMgr client, in the Preview panel).
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.           +o SiteMgr does not properly preview those documents
  405.             containing Java applets at this time. Previewing
  406.             documents of that type might be better handled through
  407.             the choice of an alternate browser (which can be chosen
  408.             within the SiteMgr client, in the Preview panel).
  409.  
  410.           +o Documents displayed using a secure channel (the "HTTPS"
  411.             protocol) need to be viewed utilizing an alternate
  412.             browser (which can be chosen within the SiteMgr client,
  413.             in the Preview panel).
  414.  
  415.           +o The built-in Previewer may have trouble with loading
  416.             certain images. If clicking the reload (circular arrow)
  417.             button does not cause these images to load, you may
  418.             want to examine how the <IMG> tags are specified. In
  419.             the case where the attribute "SGI_SRC" is set, it must
  420.             appear _b_e_f_o_r_e the attribute "SRC" (which designates the
  421.             HTTP path to the image file).
  422.  
  423.           +o The built-in Previewer has problems viewing RGB (SGI)
  424.             Image file types at this time. Previewing files of that
  425.             type might be better handled through the choice of an
  426.             alternate browser (which can be chosen within the
  427.             SiteMgr client, in the Preview panel).
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.